Installing the Kanzi build environment manually

Before you can build a Kanzi application for your target platforms, set up and configure the Kanzi build environment for your target platforms. The build environment includes tools that the Kanzi build system uses to build your application for your target platforms. Here you can find the information about what you need to install if you want to manually install the build environment for Kanzi applications.

If you want to build applications for Android, see Installing the Kanzi build environment for Android and Deploying Kanzi applications to Android.

To build and deploy Kanzi applications for other platforms, you need:

• Python 2.7.x
• Python 3.x
• Scons 2.5.1

You can find the build definitions for supported platforms in your Kanzi project directory at <KanziWorkspace>/Projects/<ProjectName>/Application/configs/platforms.

Installing the Kanzi build environment manually

To install the Kanzi build environment manually:

1. Install Python 3.x:
   1. For example, download and install Python 3.2.
   2. Add Python 3.x installation path (for example,C:\Python32) to your system path.
2. Install Python 2.7.x.
   For example, download and install Python 2.7.
3. Install SCons 2.5.1.
   For example, download and install SCons 2.5.1. During the installation select the Python 2.7.x version you installed.
4. Install Oracle Java Development Environment Kit 1.8 or newer (Windows x86, 32-bit version):
   1. Download and install Oracle Java Development Environment Kit 1.8 or newer (Windows x86, 32-bit version).
      
   2. Add %JAVA_HOME%\bin to your system path.
5. Install Apache Ant 1.9.5 or newer:
   1. Download and install Apache Ant 1.9.5 or newer.
   2. Add %ANT_HOME%\bin to your system path.
6. Set the environment variables for the software you installed. See Setting the Kanzi environment variables.

Setting the Kanzi environment variables

Kanzi Command Prompt and Kanzi Studio build system use the environment variables to build Kanzi applications.

You can set the Kanzi environment variables in these ways:

• Set the environmental variables in %ProgramData%\Rightware\<KanziVersion>\kanzi_environment_variables.bat, Kanzi's internal environment variable configuration. This allows you to configure Kanzi build environment without changing your system's environment variables. That way you can have other software on the same computer using existing configuration and tools.
  Kanzi uses your system's environment variables for all variables not set in kanzi_environment_variables.bat.
• Set the system environment variables in your computer system settings. This way you set the same environment variables for your entire computer system.
  You can access your system environment variables by right-clicking Computer in the Start Menu and by selecting Properties > Advanced System Settings > Advanced > Environment Variables.

Set these environment variables:

• PYTHON_HOME to the Python 3.x path.
  For example, C:\KanziWorkspace_3_6_3_2514\3rdPartySDKs\Python32
• SCONS_HOME to the Python 2.7.x scripts directory that contains scons.bat.
  For example, C:\KanziWorkspace_3_6_3_2514\3rdPartySDKs\Python27\Scripts
• JAVA_HOME to the JDK version 1.8 path.
  For example, C:\Program Files (x86)\Java\jdk1.8.0_60
• ANT_HOME to the Apache Ant version 1.9.5 path.
  For example, C:\KanziWorkspace_3_6_3_2514\3rdPartySDKs\apache-ant-1.9.5
• NDK_PATH to the Android NDK path.
  For example, C:\KanziWorkspace_3_6_3_2514\3rdPartySDKs\android-ndk-r10e
• ANDROID_SDK to the Android SDK path.
  For example, C:\KanziWorkspace_3_6_3_2514\3rdPartySDKs\android-sdk-windows
• KANZI_HOME to the Kanzi workspace path of the Kanzi version you want to use.
  For example, C:\KanziWorkspace_3_6_3_2514

Viewing the Kanzi environment variables

To view the current Kanzi environment variables, in Kanzi Studio select Edit > User Preferences and in the Advanced tab click Open Build Environment Configuration.

Testing your Kanzi build environment

To test whether your Kanzi build environment works, create a Kanzi application and deploy it to your platform. See Tutorial: Create a simple in-vehicle infotainment application and Deploying Kanzi applications.

See also

Installing the Kanzi build environment for Android

Deploying Kanzi applications to Android

Tutorial: Create a simple in-vehicle infotainment application

Open topic with navigation